Frame: Enhance CSS docs

Indicate how the old shadow types are replaced by CSS border-style et
al., and quote the names of nodes and classes for easier readability.

diff --git a/gtk/gtkframe.c b/gtk/gtkframe.c
index 6f109ec47977d724a6ecdc09fe0293466da6d9ae..cb8225d8baf4b5ae2c22ee5db2d8ad46c4a6a3d0 100644 (file)
--- a/gtk/gtkframe.c
+++ b/gtk/gtkframe.c
@@ -77,10 +77,14 @@
  * ╰── <child>
  * ]|
  *
- * GtkFrame has a main CSS node with name frame. This node can be given the
- * style class .flat, which is used by themes to disable drawing of the border.
- * To do this from code, call gtk_frame_set_shadow_type() with %GTK_SHADOW_NONE
- * to add the .flat class or any other shadow type to remove it.
+ * GtkFrame has a main CSS node with name “frame”, which is used to draw the
+ * visible border. You can set the appearance of the border using CSS properties
+ * like “border-style” on this node.
+ *
+ * The node can be given the style class “.flat”, which is used by themes to
+ * disable drawing of the border. To do this from code, call
+ * gtk_frame_set_shadow_type() with %GTK_SHADOW_NONE to add the “.flat” class or
+ * any other shadow type to remove it.
  */
 
 struct _GtkFramePrivate